DialogView::SetDialog

Section: ET++ method description (n)
Updated: automatically Fri Mar 15 14:08:52 1991
Index Return to Main Contents

NAME

DialogView::SetDialog - instance method

TEMPLATE

oldDialogTree = VObject * SetDialog(VObject * newDialogTree, bool redraw = TRUE)

SPECIFIERS

public

DESCRIPTION

SetDialog installs the newDialogTree and returns the oldDialogTree, the instvar dialogRoot. The whole newDialogTree is initialized and the layout is recalculated.
SetDialog is called by the method Update with the dialog tree returned by the method DoCreateDialog before this is drawn the first time. But it may also be called by the client, e.g., to switch between several dialog trees at runtime. SetDialog is used, for example, by the method TreeView::SetTree.

ARGUMENTS

VObject * newDialogTree: the new dialog tree for this
bool redraw = TRUE: indicates whether to invalidate the content rectangle of this after the newDialogTree has been set. redraw is passed to the method CalcLayout.

RETURN ARGUMENT

VObject * oldDialogTree: the old dialog tree of this. See instvar dialogRoot.

FILES

implementation:: Dialog.C

KNOWN PROBLEMS

Before setting the newDialogTree SetDialog neither empties the instvar kbdFocusItems nor clears the instvar kbdFocus and the instvar defaultButton. This doesn't matter if the dialog tree is never replaced but it may cause errors if a client explicitly sets a new dialog layout at runtime.

This document was created by man2html, using the manual pages.
Time: 00:40:28 GMT, March 30, 2022